@aura3d/cli 3.0.1 → 4.0.0

package/README.md

@@ -62,7 +62,7 @@ so the rest of the app still uses `model(assets.helmet)`.
 Meshy generation runs through the pinned official Meshy CLI. After a completed run is downloaded locally, admit a selected GLB through Aura3D:
 
 ```bash
-npx @aura3d/cli@3.0.0 assets import-meshy artifacts/meshy/arena-relic/ \
+npx @aura3d/cli@3.0.1 assets import-meshy artifacts/meshy/arena-relic/ \
   --name arenaRelic \
   --quality candidate \
   --role prop \
@@ -80,7 +80,7 @@ See the [Meshy CLI guide](https://github.com/auraoneai/aura3d/blob/main/docs/mes
 npx @aura3d/cli@latest assets add ./model.glb --name model
 npx @aura3d/cli@latest assets search "studio robot" --json
 npx @aura3d/cli@latest assets resolve "studio robot" --name robot
-npx @aura3d/cli@3.0.0 assets import-meshy artifacts/meshy/arena-relic/ --name arenaRelic --quality candidate --role prop --profile prop --rights-evidence artifacts/meshy/arena-relic/rights.json
+npx @aura3d/cli@3.0.1 assets import-meshy artifacts/meshy/arena-relic/ --name arenaRelic --quality candidate --role prop --profile prop --rights-evidence artifacts/meshy/arena-relic/rights.json
 npx @aura3d/cli@latest assets inspect ./model.glb --animation --humanoid
 npx @aura3d/cli@latest assets validate --source --release
 npx @aura3d/cli@latest assets validate-game --profile fighting-character --asset fighter

package/dist/admission/artDirection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PRD-05 §6.4 G10 (Phase 0 slice) — `stylized-flat` art-direction resolution.
+ *
+ * `stylized-flat` is the only structured replacement for the deleted
+ * `suitabilityReason` regex waiver: an untextured release asset is accepted
+ * only when its `artDirection` id resolves to an `assets/art-direction/<id>.json`
+ * document declaring `shading: "stylized-flat"` AND the entry carries an
+ * approved look-dev record bound to its current hash.
+ */
+import type { AuraCliAssetEntry } from "../asset-core-types.js";
+export interface ArtDirectionDocument {
+    readonly id: string;
+    readonly shading?: string;
+    readonly palette?: readonly string[];
+    readonly texelDensity?: number;
+    readonly referenceImages?: readonly string[];
+    readonly mix?: readonly string[];
+}
+/** Reads `assets/art-direction/<id>.json` under `projectDir`; undefined when absent/invalid. */
+export declare function readArtDirectionDocument(projectDir: string, id: string | undefined): ArtDirectionDocument | undefined;
+/** A look-dev record counts as approved when a reviewer verdict accepted the asset's current hash. */
+export declare function hasApprovedLookDevRecord(entry: Pick<AuraCliAssetEntry, "hash" | "derived" | "lookDev">): boolean;
+/**
+ * The `stylized-flat` escape for G5/the untextured-release check: art-direction
+ * doc exists, declares `shading: "stylized-flat"`, and look-dev approved.
+ */
+export declare function hasStylizedFlatApproval(projectDir: string, entry: Pick<AuraCliAssetEntry, "hash" | "derived" | "lookDev" | "artDirection">): boolean;
+//# sourceMappingURL=artDirection.d.ts.map

package/dist/admission/artDirection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artDirection.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/artDirection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAA8B,MAAM,wBAAwB,CAAC;AAE5F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,gGAAgG;AAChG,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAWrH;AAED,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAKhH;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,GAAG,OAAO,CAIpJ"}

package/dist/admission/artDirection.js

@@ -0,0 +1,47 @@
+/**
+ * PRD-05 §6.4 G10 (Phase 0 slice) — `stylized-flat` art-direction resolution.
+ *
+ * `stylized-flat` is the only structured replacement for the deleted
+ * `suitabilityReason` regex waiver: an untextured release asset is accepted
+ * only when its `artDirection` id resolves to an `assets/art-direction/<id>.json`
+ * document declaring `shading: "stylized-flat"` AND the entry carries an
+ * approved look-dev record bound to its current hash.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+/** Reads `assets/art-direction/<id>.json` under `projectDir`; undefined when absent/invalid. */
+export function readArtDirectionDocument(projectDir, id) {
+    if (!id || !/^[a-z0-9][a-z0-9-_]*$/i.test(id))
+        return undefined;
+    const file = resolve(projectDir, "assets", "art-direction", `${id}.json`);
+    if (!existsSync(file))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        if (parsed === null || typeof parsed !== "object")
+            return undefined;
+        return { id, ...parsed };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A look-dev record counts as approved when a reviewer verdict accepted the asset's current hash. */
+export function hasApprovedLookDevRecord(entry) {
+    const record = entry.lookDev;
+    if (!record || record.reviews.length === 0)
+        return false;
+    const boundHash = record.derivedHash ?? entry.derived?.hash ?? entry.hash;
+    return record.reviews.some((review) => review.verdict === "accept") && boundHash === (entry.derived?.hash ?? entry.hash);
+}
+/**
+ * The `stylized-flat` escape for G5/the untextured-release check: art-direction
+ * doc exists, declares `shading: "stylized-flat"`, and look-dev approved.
+ */
+export function hasStylizedFlatApproval(projectDir, entry) {
+    const document = readArtDirectionDocument(projectDir, entry.artDirection);
+    if (document?.shading !== "stylized-flat")
+        return false;
+    return hasApprovedLookDevRecord(entry);
+}
+//# sourceMappingURL=artDirection.js.map

package/dist/admission/artDirection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artDirection.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/artDirection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,gGAAgG;AAChG,MAAM,UAAU,wBAAwB,CAAC,UAAkB,EAAE,EAAsB;IACjF,IAAI,CAAC,EAAE,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpE,OAAO,EAAE,EAAE,EAAE,GAAI,MAAkC,EAA0B,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,KAA8D;IACrG,MAAM,MAAM,GAAG,KAAK,CAAC,OAAiD,CAAC;IACvE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,IAAI,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3H,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,KAA+E;IACzI,MAAM,QAAQ,GAAG,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC1E,IAAI,QAAQ,EAAE,OAAO,KAAK,eAAe;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/admission/audio.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PRD-05 R-09-1 (request from lane 09) — synthesized-audio release rule.
+ *
+ * `assets validate --release` fails an `audio` entry whose provenance is
+ * synthesized unless its id is on `AUDIO_SYNTH_RELEASE_ALLOWLIST`. The
+ * allowlist starts empty: all 178 in-repo synthesized audio entries are
+ * `candidate`/`ungraded` today, so admitting one is a deliberate, auditable
+ * act (lane 09 owns the entries, lane 05 owns the rule).
+ */
+import type { AuraCliAssetProvenance } from "../asset-core-types.js";
+/** Ids allowed to hold `quality: "release"` with synthesized provenance. */
+export declare const AUDIO_SYNTH_RELEASE_ALLOWLIST: readonly string[];
+/**
+ * Provenance counts as synthesized when its own fields say the bytes were
+ * generated in-repo — `author`/`sourceFamily`/`attribution`/`evidence`
+ * mentioning synthesis, or a builder-script source page.
+ */
+export declare function isSynthesizedAudioProvenance(provenance: Pick<AuraCliAssetProvenance, "author" | "sourceFamily" | "attribution" | "evidence" | "sourcePage"> | undefined): boolean;
+//# sourceMappingURL=audio.d.ts.map

package/dist/admission/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAAO,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,CAAC,GAAG,SAAS,GAAG,OAAO,CAWjL"}

package/dist/admission/audio.js

@@ -0,0 +1,31 @@
+/**
+ * PRD-05 R-09-1 (request from lane 09) — synthesized-audio release rule.
+ *
+ * `assets validate --release` fails an `audio` entry whose provenance is
+ * synthesized unless its id is on `AUDIO_SYNTH_RELEASE_ALLOWLIST`. The
+ * allowlist starts empty: all 178 in-repo synthesized audio entries are
+ * `candidate`/`ungraded` today, so admitting one is a deliberate, auditable
+ * act (lane 09 owns the entries, lane 05 owns the rule).
+ */
+/** Ids allowed to hold `quality: "release"` with synthesized provenance. */
+export const AUDIO_SYNTH_RELEASE_ALLOWLIST = [];
+/**
+ * Provenance counts as synthesized when its own fields say the bytes were
+ * generated in-repo — `author`/`sourceFamily`/`attribution`/`evidence`
+ * mentioning synthesis, or a builder-script source page.
+ */
+export function isSynthesizedAudioProvenance(provenance) {
+    if (!provenance)
+        return false;
+    const blob = [
+        provenance.author ?? "",
+        provenance.sourceFamily ?? "",
+        provenance.attribution ?? "",
+        provenance.sourcePage ?? "",
+        ...(provenance.evidence ?? []),
+    ].join("\n");
+    if (/(?:synthesi[sz]ed|synth\b|procedurally generated|deterministic(?:ally)? (?:synth|generated))/i.test(blob))
+        return true;
+    return /(^|\/)apps\/[^/]+\/scripts\/(?:build|blender-build|build-review|register)-[^/]*\.(?:mjs|ts|py)$/i.test(provenance.sourcePage ?? "");
+}
+//# sourceMappingURL=audio.js.map

package/dist/admission/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAsB,EAAE,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAA2H;IACtK,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,IAAI,GAAG;QACX,UAAU,CAAC,MAAM,IAAI,EAAE;QACvB,UAAU,CAAC,YAAY,IAAI,EAAE;QAC7B,UAAU,CAAC,WAAW,IAAI,EAAE;QAC5B,UAAU,CAAC,UAAU,IAAI,EAAE;QAC3B,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,IAAI,+FAA+F,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5H,OAAO,kGAAkG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AAC9I,CAAC"}

package/dist/admission/builder-patterns.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PRD-05 §6.4 G5 — in-repo builder patterns. Assets whose provenance or glTF
+ * `asset.generator` matches the repo's scripted-geometry builders are
+ * programmer art: capped at `prototype` (role `proxy` allowed) unless they
+ * pass G2, G3, G6 and a G9 record with a named human reviewer.
+ *
+ * Sources:
+ *  - script paths under `apps/<app>/scripts/` named
+ *    `build-*.mjs|ts`, `build-*.py`, `blender-build-*.py`,
+ *    `build-review-*.mjs`, `register-*.mjs` (60+ such scripts exist today).
+ *  - generator strings emitted by those builders: "Deep Recovery procedural
+ *    GLB synth", "modular family synth", "deterministic * builder".
+ *
+ * `tests/unit/aura3d-cli/admission-gates.test.ts` enumerates
+ * `git ls-files` over the builder-script glob and asserts every
+ * builder-script name still matches, so new builder scripts cannot slip
+ * past the pattern list.
+ */
+export declare const BUILDER_SOURCE_PATH_PATTERNS: readonly RegExp[];
+export declare const BUILDER_GENERATOR_PATTERNS: readonly RegExp[];
+/** True when the file name (basename or repo-relative path) is a builder script. */
+export declare function isBuilderScriptPath(path: string | undefined): boolean;
+/** True when a glTF `asset.generator` or provenance generation string is an in-repo builder. */
+export declare function isBuilderGenerator(generator: string | undefined): boolean;
+//# sourceMappingURL=builder-patterns.d.ts.map

package/dist/admission/builder-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-patterns.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/builder-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAEzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIrE;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGzE"}

package/dist/admission/builder-patterns.js

@@ -0,0 +1,40 @@
+/**
+ * PRD-05 §6.4 G5 — in-repo builder patterns. Assets whose provenance or glTF
+ * `asset.generator` matches the repo's scripted-geometry builders are
+ * programmer art: capped at `prototype` (role `proxy` allowed) unless they
+ * pass G2, G3, G6 and a G9 record with a named human reviewer.
+ *
+ * Sources:
+ *  - script paths under `apps/<app>/scripts/` named
+ *    `build-*.mjs|ts`, `build-*.py`, `blender-build-*.py`,
+ *    `build-review-*.mjs`, `register-*.mjs` (60+ such scripts exist today).
+ *  - generator strings emitted by those builders: "Deep Recovery procedural
+ *    GLB synth", "modular family synth", "deterministic * builder".
+ *
+ * `tests/unit/aura3d-cli/admission-gates.test.ts` enumerates
+ * `git ls-files` over the builder-script glob and asserts every
+ * builder-script name still matches, so new builder scripts cannot slip
+ * past the pattern list.
+ */
+export const BUILDER_SOURCE_PATH_PATTERNS = [
+    /(^|\/)apps\/[^/]+\/scripts\/(?:build|blender-build|build-review|register)-[^/]*\.(?:mjs|ts|py)$/i,
+];
+export const BUILDER_GENERATOR_PATTERNS = [
+    /deep recovery procedural glb synth/i,
+    /modular family synth/i,
+    /deterministic[^,;\n]*builder/i,
+];
+/** True when the file name (basename or repo-relative path) is a builder script. */
+export function isBuilderScriptPath(path) {
+    if (!path)
+        return false;
+    const normalized = path.replace(/\\/g, "/");
+    return BUILDER_SOURCE_PATH_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+/** True when a glTF `asset.generator` or provenance generation string is an in-repo builder. */
+export function isBuilderGenerator(generator) {
+    if (!generator)
+        return false;
+    return BUILDER_GENERATOR_PATTERNS.some((pattern) => pattern.test(generator));
+}
+//# sourceMappingURL=builder-patterns.js.map

package/dist/admission/builder-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-patterns.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/builder-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC7D,kGAAkG;CACnG,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,qCAAqC;IACrC,uBAAuB;IACvB,+BAA+B;CAChC,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAAC,SAA6B;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/admission/gates.d.ts

@@ -0,0 +1,136 @@
+/**
+ * PRD-05 §6.4 — visual-quality admission gates (Phase 0 slice).
+ *
+ * Pure functions over parsed glTF JSON + accessor counts. Implemented here:
+ * G1 (triangle band), G3 (PBR slot coverage), G4 (card ban), G5
+ * (programmer-art ban), G8 (tangents when normal-mapped), G11 (derived
+ * present). G2, G6, G7, G9, G10 landed in Phase 4 (`assets admit`) —
+ * measured-input gates, pure over the reports produced by admission/texel.ts
+ * and admission/textureStats.ts.
+ *
+ * "Rendered surface area" is approximated by primitive triangle counts —
+ * these functions intentionally take accessor counts, not vertex buffers, so
+ * they run on the JSON chunk alone.
+ */
+import type { AssetQualityCheck } from "../contracts/assetManifest.js";
+import type { AuraCliAssetRole, AuraCliLookDevReview } from "../asset-core-types.js";
+import type { ArtDirectionDocument } from "./artDirection.js";
+import type { TexelDensityReport } from "./texel.js";
+import type { TextureSanityReport } from "./textureStats.js";
+import { type AdmissionProfile } from "./profiles.js";
+export type AdmissionGateId = `G${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11}`;
+/** One mesh primitive reduced to what the gates read (accessor counts + attribute presence). */
+export interface AdmissionPrimitive {
+    readonly triangleCount: number;
+    readonly materialIndex?: number;
+    readonly hasTexcoord0: boolean;
+    readonly hasTangent: boolean;
+}
+export interface AdmissionMaterial {
+    readonly name?: string;
+    readonly hasBaseColorTexture: boolean;
+    readonly hasNormalTexture: boolean;
+    readonly hasMetallicRoughnessTexture: boolean;
+    /** True when the material carries an occlusion texture (aoMap). */
+    readonly hasOcclusionTexture: boolean;
+    /** True when the material references no texture at all (factors only). */
+    readonly factorOnly: boolean;
+    /** KHR_materials_unlit. */
+    readonly unlit: boolean;
+}
+export interface AdmissionModel {
+    readonly generator?: string;
+    readonly primitives: readonly AdmissionPrimitive[];
+    readonly materials: readonly AdmissionMaterial[];
+    /** Any mesh bound to a skin. */
+    readonly skinned: boolean;
+    /** LOD0 triangle total across primitives. */
+    readonly totalTriangles: number;
+    /** World-space bounds from POSITION accessor min/max (if declared). */
+    readonly boundsSize?: readonly [number, number, number];
+}
+/** Manifest/provenance context a gate may read besides the geometry. */
+export interface AdmissionEntryContext {
+    readonly id: string;
+    readonly role?: AuraCliAssetRole | string;
+    readonly quality?: string;
+    /** `provenance.sourcePath` (or the entry `source` when provenance is absent). */
+    readonly sourcePath?: string;
+    /** `provenance.generation.provider` / generator id recorded by the generator pipeline. */
+    readonly generationProvider?: string;
+    /** Entry already carries a `derived` record (or `derived.optimize === "not-needed"`). */
+    readonly derivedPresent?: boolean;
+    /** `artDirection` resolved to a `stylized-flat` doc with an approved look-dev record. */
+    readonly stylizedFlatApproved?: boolean;
+    /** Manifest `artDirection` id (G10: resolves to assets/art-direction/<id>.json). */
+    readonly artDirection?: string;
+}
+/** G1 — LOD0 triangles within [floor, ceiling] of the role profile (§6.2). */
+export declare function gateG1TriangleBand(model: AdmissionModel, profile: AdmissionProfile | undefined): AssetQualityCheck;
+/**
+ * G3 — PBR completeness: TEXCOORD_0 + base colour + normal + metallic-
+ * roughness on ≥ 90 % of rendered area (occlusion required on non-skinned
+ * meshes, optional on skinned). Roles outside the PBR-required list record
+ * `waived-by-role`.
+ */
+export declare function gateG3PbrCompleteness(model: AdmissionModel, role: AuraCliAssetRole | string | undefined, profile: AdmissionProfile | undefined, stylizedFlatApproved?: boolean): AssetQualityCheck;
+/**
+ * G4 — card ban. Fails when LOD0 ≤ 12 triangles, `KHR_materials_unlit` on
+ * > 10 % of area, or bounds thinness ratio min/max < 0.02 with ≤ 4 triangles.
+ * `backdrop`/`debug`/`abstract` roles are exempt.
+ */
+export declare function gateG4CardBan(model: AdmissionModel, role: AuraCliAssetRole | string | undefined): AssetQualityCheck;
+export interface GateG5Result extends AssetQualityCheck {
+    /** True when the failure is the in-repo builder provenance (role `proxy` cap). */
+    readonly builderProvenance?: boolean;
+}
+/**
+ * G5 — programmer-art ban. Fails when > 10 % of area lacks TEXCOORD_0, when
+ * every material is factor-only without an approved stylized-flat art
+ * direction, or when provenance/generator matches the in-repo builder list.
+ */
+export declare function gateG5ProgrammerArt(model: AdmissionModel, entry: AdmissionEntryContext): GateG5Result;
+/** G8 — every primitive whose material has a normal map must carry TANGENT. */
+export declare function gateG8Tangents(model: AdmissionModel): AssetQualityCheck;
+/** G11 — `release` requires a `derived` record (or `optimize: "not-needed"` with measurements). */
+export declare function gateG11Derived(entry: AdmissionEntryContext): AssetQualityCheck;
+/** Measured inputs for the Phase-4 gates; callers build these per entry. */
+export interface AdmissionMeasured {
+    /** G2: texel-density report (admission/texel.ts) at the resolved camera, 1920×1080. */
+    readonly texelDensity?: TexelDensityReport;
+    /** G2: same report at the §6.4 mobile viewport 390×844. */
+    readonly texelDensityMobile?: TexelDensityReport;
+    /** G6: per-slot texture sanity (admission/textureStats.ts). */
+    readonly textureSanity?: TextureSanityReport;
+    /** G7: derived file bytes + GPU bytes + draw calls (High tier). */
+    readonly derivedFileBytes?: number;
+    readonly gpuBytesHigh?: number;
+    readonly drawCalls?: number;
+    /** G9: the entry's look-dev record (manifest `lookDev`) bound to current hash. */
+    readonly lookDev?: {
+        readonly derivedHash?: string;
+        readonly stageVersion?: string;
+        readonly reviews: readonly AuraCliLookDevReview[];
+    };
+    /** G9: Aura-adapter look-dev score (three-minus-Aura gap > 1.5 → renderer issue). */
+    readonly auraScore?: number;
+    /** G10: resolved `assets/art-direction/<id>.json` (undefined = file missing). */
+    readonly artDirectionDoc?: ArtDirectionDocument;
+}
+/** G2 — median-area-triangle texels/screen-pixel within [0.5, 4] at the role camera. */
+export declare function gateG2TexelDensity(model: AdmissionModel, profile: AdmissionProfile | undefined, measured: AdmissionMeasured): AssetQualityCheck;
+/** G6 — texture sanity on 256² decoded proxies. */
+export declare function gateG6TextureSanity(profile: AdmissionProfile | undefined, measured: AdmissionMeasured): AssetQualityCheck;
+/** G7 — derived file bytes + GPU bytes + draw calls within the §17.2 role budget. */
+export declare function gateG7Budget(profile: AdmissionProfile | undefined, measured: AdmissionMeasured): AssetQualityCheck;
+/** G9 — look-dev record: three-adapter score ≥ 6.5, no axis < 4, hero needs a named human; Aura gap > 1.5 is a renderer issue, not an asset failure. */
+export interface GateG9Result extends AssetQualityCheck {
+    /** Set when Aura-minus-three gap > 1.5 — file a renderer issue (qr-ic-regression), not an asset failure. */
+    readonly rendererIssue?: boolean;
+}
+export declare function gateG9LookDev(entry: AdmissionEntryContext, profile: AdmissionProfile | undefined, measured: AdmissionMeasured): GateG9Result;
+/** G10 — art-direction document exists; `stylized-flat` additionally needs UVs + human review. */
+export declare function gateG10ArtDirection(model: AdmissionModel, entry: AdmissionEntryContext, measured: AdmissionMeasured): AssetQualityCheck;
+/** Runs all admission gates; measured gates need `measured` inputs (Phase 4). */
+export declare function runAdmissionGates(model: AdmissionModel, entry: AdmissionEntryContext, measured?: AdmissionMeasured): readonly AssetQualityCheck[];
+//# sourceMappingURL=gates.d.ts.map

package/dist/admission/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/admission/gates.ts"],"names":[],"mappings":"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"}